﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="AAuto" />
<title>文件操作</title>
<link href="../../../style.css" rel="stylesheet" type="text/css" />
</head>

<body>
<div id="maincontent">
	<h1>fsys库</h1>
	<div class="desc">fsys库主要提供对window系统的文件路径、属性操作函数。</div>
	<div>
		<h2>fsys.shortpath</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.shortpath( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>将文件路径转换为短文件名。</p>
	</div>
	<!--fsys.shortpath-->
	<div>
		<h2>fsys.longpath</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.longpath( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>将文件路径转换为长文件名。</p>
	</div>
	<!--fsys.longpath-->
	<div>
		<h2>fsys.joinpath</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.joinpath( dir,path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>合并文件路径。</p>
	</div>
	<!--fsys.joinpath-->
	<div>
		<h2>fsys.getCurDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.getCurDir( )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>获取当前目录。</p>
	</div>
	<!--fsys.getCurDir-->
	<div>
		<h2>fsys.setCurDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.setCurDir( )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>设置当前目录。</p>
		<p><strong>3、函数示例：</strong></p>
		<div class="codeblock"> io.open();<span class="comment">//打开控制台</span><br />
			<br />
			<span class="kw">import</span> fsys;<br />
			<span class="kw">var</span> path = fsys.getCurDir();<br />
  io.print(<span class="string">"当前目录：",</span> path );<br />
			fsys.setCurDir( fsys.getWinDir() ) <span class="comment">//设置当前目录为windows目录</span><br />
			io.print( <span class="string">"重新设置目录："</span>,fsys.getCurDir() ); <span class="comment">//获取当前目录</span><br />
			<br />
			<span class="comment">//重新设置当前目录为程序目录</span><br />
			fsys.setCurDir( io._exedir ); <br />
			<br />
			<span class="kw">execute</span>(<span class="string">"pause"</span>) <span class="comment">//按任意键继续</span><br />
			io.close();<span class="comment">//关闭控制台</span><br />
		</div>
		<div class="tip"> <img src="../../../icon/info.gif" alt="" width="16" height="16" align="absmiddle" />如果不重新设置当前目录，则第二次运行上面代码均显示为windows目录</div>
	</div>
	<!--fsys.setCurDir-->
	<div>
		<h2>fsys.getSysDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.getSysDir( )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>返回系统目录。</p>
	</div>
	<!--fsys.getSysDir-->
	<div>
		<h2>fsys.getWinDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.getWinDir( )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>返回windows目录。</p>
	</div>
	<!--fsys.getWinDir-->
	<div>
		<h2>fsys.getTempDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.getTempDir( )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>返回临时目录。</p>
	</div>
	<!--fsys.getTempDir-->
	<div>
		<h2>fsys.createDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.createDir( strDir )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p> 创建目录路径，返回创建成功的完整文件路径。</p>
		<p><strong>3、函数示例：</strong></p>
		<div class="codeblock"> io.open();<span class="comment">//打开控制台</span><br />
			<span class="kw">import</span> fsys;<br />
			io.print( fsys.getCurDir() );<br />
			<span class="kw">var</span> path = fsys.createDir(<span class="string">"新建文件夹"</span>);<span class="comment">//在当前目录下创建文件夹</span><br />
			io.print( path )<br />
			path = fsys.createDir(<span class="string">"C:\AAuto"</span>);<span class="comment">//在其他盘建</span><br />
			io.print( path )<br />
			<span class="kw">execute</span>("pause") <span class="comment">//按任意键继续</span><br />
			io.close();<span class="comment">//关闭控制台</span><br />
		</div>
	</div>
	<!--fsys.createDir-->
	<div>
		<h2>fsys.getParentDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.getParentDir( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>返回指定路径的父目录。</p>
		<p><strong>3、函数示例：</strong></p>
		<div class="codeblock"> <span class="kw">import</span> fsys;<br />
			<span class="kw">var</span> path = fsys.getParentDir( fsys.getCurDir() ); <br />
			io.print( path )<br />
		</div>
	</div>
	<!--fsys.getParentDir-->
	<div>
		<h2>fsys.createParentDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.createParentDir( strDir )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>创建指定路径的父目录。</p>
		<p><strong>3、函数示例：</strong></p>
		<div class="codeblock"><span class="kw">import</span> fsys;<br />
			fsys.createParentDir(<span class="string">"C:\AA\BB\CC"</span>)<span class="comment">//创建C:\AA\BB文件夹</span></div>
	</div>
	<!--fsys.createParentDir-->
	<div>
		<h2>fsys.searchFile</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.searchFile( filename [,...] )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>检查指定目录下是否包含指定文件，如果存在返回完整路径,否则返回null。<br />
			如果第二参数为空，则依次在程序根目录、当前工作目录、系统目录查找。</p>
	</div>
	<!--fsys.searchFile-->
	<div>
		<h2>fsys.getSpecial</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.getSpecial( [id=0<span class="comment">/*_CSIDL_DESKTOP*/</span>] )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>获取指定目录，参数为_CSIDL_开头的常量，默认获取桌面目录。</p>
	</div>
	<!--fsys.getSpecial-->
	<div>
		<h2>fsys.delete</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.delete( from [,flag] )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p> 删除文件或目录。</p>
		<div class="tip"><img src="../../../icon/info.gif" width="16" height="16" alt="" align="absmiddle" /> 路径参数可以是多个路径组成的数组，支持非空目录,文件名支持通配符，可选增加一个参数,使用_FOF_前缀常量指定附加选项。 move()、copy()、rename()同样。 </div>
	</div>
	<!--fsys.delete-->
	<div>
		<h2>fsys.move</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.move( from ,to [,flag] )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>移动文件或目录。</p>
	</div>
	<!--fsys.move-->
	<div>
		<h2>fsys.copy</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.copy( from ,to [,flag] )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>复制文件或目录。</p>
	</div>
	<!--fsys.copy-->
	<div>
		<h2>fsys.rename</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.rename( from ,to [,flag] )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>重命名文件或目录。 </p>
	</div>
	<!--fsys.rename-->
	<div>
		<h2>fsys.enmu</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.enmu( dir [,p=<span class="string">"*.*"</span>] ,proc [,enumSubdir=<span class="kw">true</span><span class="comment">/*是否搜索子目录*/</span>])</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>遍历目录。</p>
		<p><strong>3、函数示例：</strong></p>
		<div class="codeblock"> io.open();<span class="comment">//打开控制台</span><br />
			<span class="kw">import</span> fsys;<br />
			fsys.enum(  io._exedir + <span class="string">"\lib"</span>,<br />
			&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="string">"*.*"</span>,<br />
			&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="kw">function</span>(dir,file,fullpath,findData)<br />
			&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="kw">if</span>(file){ <br />
			&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;io.print(<span class="string">"发现文件："</span>+file,<span class="string">"完整路径："</span>+fullpath)<br />
			&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<span class="kw">else</span>{<br />
			&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;io.print(<span class="string">"发现目录：" </span>+ dir)<br />
			&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<br />
			&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<br />
			&nbsp;&nbsp;,<span class="kw">false</span><span class="comment">/*不搜索子目录*/</span>);<br />
			<span class="kw">execute</span>(<span class="string">"pause"</span>) <span class="comment">//按任意键继续</span><br />
			io.close();<span class="comment">//关闭控制台</span><br />
		</div>
	</div>
	<!--fsys.enmu-->
	<div>
		<h2>fsys.attrib</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.attrib( path [,_FILE_ATTRIBUTE_<span class="comment">/*移除属性*/</span> [,_FILE_ATTRIBUTE_<span class="comment">/*添加属性*/</span>]] )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>返回、移除、添加文件属性，成功返回新属性，失败返回null。<br />
			属性参数为_FILE_ATTRIBUTE_前缀的常量，多个属性可以用 "|" 连接符连接。</p>
		<div class="tip"><img src="../../../icon/info.gif" width="16" height="16" alt="" align="absmiddle" />只保留第一参数为返回文件属性、第三参数为空则移除属性、第二参数为空则添加属性</div>
	</div>
	<!--fsys.attrib-->
	<div>
		<h2>fsys.isDir</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.isDir( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>判断路径是否是目录，调用attrib检查文件是否<span class="comment">_FILE_ATTRIBUTE_DIRECTORY</span>属性。</p>
	</div>
	<!--fsys.isDir-->
	<div>
		<h2>fsys.isReadonly</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.isReadonly( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>判断文件是否只读，调用attrib检查文件是否具有<span class="comment">_FILE_ATTRIBUTE_READONLY</span>属性。</p>
	</div>
	<!--fsys.isReadonly-->
	<div>
		<h2>fsys.isSystem</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.isSystem( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>判断文件是否为系统文件，调用attrib检查文件是否具有<span class="comment">_FILE_ATTRIBUTE_SYSTEM</span>属性。</p>
	</div>
	<!--fsys.isSystem-->
	<div>
		<h2>fsys.isHidden</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.isHidden( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>判断文件是否为隐藏文件，调用attrib检查文件是否具有<span class="comment">_FILE_ATTRIBUTE_HIDDEN</span>属性。</p>
	</div>
	<!--fsys.isHidden-->
	<div>
		<h2>fsys.formatSize</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.formatSize( size )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p> 转换数字字节值到KB，MB，GB。</p>
	</div>
	<!--fsys.formatSize-->
	<div>
		<h2>fsys.compact</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.compact( path [,pix=300] )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>截断路径来适合一定数目的像素。</p>
	</div>
	<!--fsys.compact-->
	<div>
		<h2>fsys.commonPrefix</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.commonPrefix( path ,path2)</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>返回两个文件路径的公共前缀。</p>
	</div>
	<!--fsys.commonPrefix-->
	<div>
		<h2>fsys.canonicalize</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.canonicalize( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>对路径进行归一化处理，<br />
			扩展和适当置换路径中包含的所有..和.。</p>
	</div>
	<!--fsys.isHidden-->
	<div>
		<h2>fsys.addBackslash</h2>
		<p><strong>1、函数原型：</strong></p>
		<pre>fsys.addBackslash( path )</pre>
		<p><strong>2、函数说明：</strong></p>
		<p>在目录路径后添加"\"。</p>
	</div>
	<!--fsys.isHidden--> 
</div>
</body>
</html>